APPLESOFT Il: EXTENDED, 
FLOATING—POINT BASIC 


QUICK REFERENCE GUIDE 
SIMPLE VARIABLES 


Type Name Range 
Real AB +/- 9.99999999 E+37 
Integer ABZ +/- 32767 
String ABS @ to 255 characters 


~ 


Where A is a letter, B is a letter or digit. 
Name may be more than two characters, but 
only first two are significant: AB% and 
AB3QS% are the same integer variable. 


ARRAY VARIABLES 


Type Name of Typical Element 
Real AB(3,12,7) 
Integer ABZ(3,12,7) 
String ABS$(3,12,7) 


Array size is limited by available memory. 


ALGEBRAIC OPERATORS 


Assigns value to variable (LET optional) 
Negation 

Exponentiation 

Multiplication 

Division 

Addition 

Subtraction 


) 


1+“ * 


RELATIONAL AND LOGICAL 
OPERATORS 


= Equal 

<> Not equal 

< Less than 

> Greater than 


<= Less than or equal 
= Greater than or equal. 


NOT Logical "Not" 
AND Logical "And" 
OR Logical "Or" 


Relational and logical expressions have value - 
1 if true, 9 if false.“ Relational operator, 
can also be used to compare strings. 


SYSTEM AND UTILITY COMMANDS 


LOAD Loads a program from tape. 
SAVE Saves a program on tape. 
NEW Deletes current program. 
RON Executes program starting 


at lowest line number. 
RUN 477 Executes program starting 
at line 477. 


STOP Halts execution and tells 
in which line. 

END Halts execution with no 
message. 


etri C Used in immediate mode to halt 
program or listing. 

reset Unconditional jump to Monitor. 

Use ctrl C or $G to return 
to APPLESOFT. 

CONT Continues program execution 
stopped by STOP, END or ctrl C. 

TRACE Debugging aid; lists each line 
number as it is executed. 

NOTRACE Turns off TRACE. 

PEEK(X) Returns contents of memory 
location X. 

POKE X,13 Changes contents of memory 
location X to the value 13. 

WAIT X,Y,Z Waits until contents of location 
X, when XORed with Z and ANDed 
with Y, gives non-zero result. 

CALL X Goes to machine-language subroutine 
beginning at memory location X. 

USR (X) Passes value X to a machine-language 
subroutine. 

HIMEM: Sets highest memory address available 
to APPLESOFT program use. 

LOMEM: Sets lowest memory address available 
to APPLESOFT program use. 


EDITING AND FORMAT-RELATED 
COMMANDS 


LIST Lists entire program. 

LIST X-Y Lists from line X to line Y. 

DEL X,Y Deletes from line X to line Y. 

REM KYZ For writing program comments; 
ignored by program. 

VITAB Y Moves cursor to line Y (1 to 24). 

HTAB X Moves cursor to position X (1 to 4@). 

TAB(X) Only in PRINT statement; moves 
cursor to position X (1 to 4@). 

POS(@) Returns current horizontal position 
of cursor (@ to 39). 

SPC(X) Only in PRINT statement; puts X 
spaces between last item printed 
and next. 

HOME Clears screen and puts cursor at top. 

CLEAR Resets all variables to zero. 


EDITING AND FORMAT-RELATED 
COMMANDS (contd) 


FRE(@) Returns amount of memory still 
available to user. 
FLASH Sets computer output to flashing. 
INVERSE Sets computer output to black on 
white. 
NORMAL Turns off flashing or inverse output. 
SPEED=X Sets character output rate 
(@ to 255). 


esc A Moves cursor one space right. 
esc B Moves cursor one space left. 
esc C Moves cursor one space down. 
esc D Moves cursor one space up. 


right-arrow Enters character under cursor 
into memory, and moves cursor one 
Space right. 

left-arrow Deletes one character from line 
being typed, and moves cursor one 
Space left. 


ctrl X Cancels line currently being typed. 


ARRAYS AND STRINGS 


DIM A(X,Y,Z) Sets maximum subscripts for A; 
reserves memory space for 
X+1 * Y+l * Z+l real elements, starting 
with A(G,9,9).- 

DIN AS(X,Y) Sets maximum subscripts for AS, 
which may contain X+l * Y+l strings 
elements, each of up to 255 characters. 

LEN (AS) Returns number of characters in AS. 

STRS$ (X) Returns numeric value of X, 
converted to a string. 

VAL (AS) Returns A$, up to the first non- 
numeric character, as a numeric value. 

CHR S$ (X) Returns ASCII character whose code 
is X. 

ASC (AS) Returns ASCII code for first 
character of AS. 

LEFTS$ (AS, X) Returns leftmost X characters 
of AS. 

RIGHTS$(A$,X) Returns rightmost X characters 
of AS. 

MID$(A$,X,Y) Returns Y characters of AS, 
Starting at character X. 


+ Operator used to concatenate strings. 


STORE A Saves numeric array A on tape. 
Cannot be used to Save string arrays, 
directly. 

RECALL B- Loads array back from tape; array B 
must have been DIMensioned correctly. 


INPUT/OUTPUT COMMANDS 
{Also see LOAD and SAVE, STORE and RECALL. } 


INPUT A$ Puts ? on screen; waits for user 
to type-a string value for AS. 

INPUT “XYZ"3A Prints XYZ on screen; waits 
for user to type a real number value 

; for A. 

GET A$ Waits for user to type a one=- 
_character value for A$; does not need 
RETURN key. 

DATA X,"Y",Z Establishes list of data 
elements that can be used by READ 
Statements. 

READ A$ Assigns next DATA element to AS. 

RESTORE Starts READing from first DATA 

. -@lement again. 

PRINT "X= "3X Prints string X= and value 
of variable X on screen. Semicolons 
concatenate printed items, commas 
separate items into three tab fields. 
The symbol ? also means PRINT. 

IN#6 Takes future input from peripheral 
device in slot#6, instead of from 
keyboard (IN#@). 

PR #6 Sends output to peripheral device in 
slot#6, instead of to TV screen (PR#¢). 

LET X=Y LET is optional; assigns value 
of Y to variable X. 

DEF FN A(X)=X+23/X Defines a function FNA. 
In later use, the argument of FNA will 
be substituted for X in the defined 
expression. FNA(4) would return 9.75 


COMMANDS RELATING a 
FLOW OF CONTROL 


GOTO 347 Branches to line 347. 

IF X=3 THEN STOP If the assertion X=3 is 
true (non-zero), then execution 
continues. If the assertion is false 
(zero), then execution jumps to the next 
numbered line. 

FOR X=l TO 29 STEP 4 ... NEXT X 
Executes all statements between the FOR 
Statement and the corresponding NEXT, 
first with X=l, then with X=5, X#9, etc. 
until X>2¢, when execution continues 
after NEXT. STEP size is 1 if not 
specified. 

NEXT X Defines bottom of FOR...NEXT loop. 
The X is optional. 

GOSUB 33 Branches to the subroutine at 
line 33. . . 


a 


COMMANDS RELATING TO 
FLOW OF CONTROL (contd) 


RETURN Marks end of subroutine; returns to 
Statement following most recent GOSUB. 

POP Removes one address from RETURN the 
address stack. 

ON X GOTO 397,12,458 Branches to the Xth 
line number in the list. If X=2, goes 
to line 12. 

ON X GOSUB 397,12,458 Branches to 
subroutine at the Xth line number in 
the list. 

ONERR GOTO 4599 Subsequent errors cause 
branch to error-handling routine 
at line 4599 instead of message and 
program halt. 

RESUME In error-handling routine, causes 
return to statement where error occurred. 


GRAPHICS AND 
GAME CONTROLS 


Low-Resolution Graphics 


GR Sets low-resolution graphics; clears 
top 49 x 49 area to black; bottom 4 
lines text. 

COLOR=X Sets color (@ to 15) for next 
plotting. 

PLOT X,Y Places colored dot at horizontal 
coordinate X and vertical coordinate Y. 
X and Y are from @ to 39. G,@ is top 
left. 

HLIN X1,X2 AT Y Draws horizontal line from 
the point at X1,Y to the point at X2,Y. 

VLIN Y1,Y¥2 AT X Draws vertical line from 
the point at X,Yl to the point at X,Y2. 

SCRN (X,Y) Returns color on screen at the 
point X,Y. 


High-Resolution Graphics 


HGR Sets high-resolution graphics, page Il; 
clears top 28@ x 169 area to black; 
bottom 4 lines text. 

HGR2 Sets high-resolution graphics, page 2; 
clears entire 289% x 192 screen to black. 

HCOLOR=X Sets color (%@ to 7) for next 
plotting. 

HPLOT X,Y Places colored dot at horizontal 
coordinate X and vertical coordinate Y. 
X is from $9 to 279; Y is from @ to 159 
(HGR) or to 191 (HGR2). 9,9 is top 
left corner. 


GRAPHICS AND 
GAME CONTROLS (contd) 


HPLOT X1,Y1 TO X2,Y2 Draws line from the 
point at X1,Yl to the point at X2,Y2. 
Command may be extended to additional 
points...TO XN, YN. 


SHLOAD Loads a shape table from tape. 

DRAW 3 AT X,Y Draws shape definition #3 
from a previously loaded shape table, 
starting at the point X,Y in color set 
by HCOLOR. 


- XDRAW 3 AT X,Y Draws shape definition #3 


from shape table; color of each point 
plotted is complement of color on 
screen at that point. 

ROT=X Sets rotation of shape for DRAW or 
XDRAW. ROT=@ is vertical, ROT=16 is 
99 degrees clockwise, ROT=32 is 
189 degrees clockwise, etc. 

SCALE=X Sets scale (1 to 255) of shape for 
DRAW or XDRAW. 


Game Controls 


PDL(X) Returns setting from 9 to 255 of 
game control X (@ to 3). 

PEEK (X~162387) If >127, button on game 
control X (@ to 2) is being pressed. 

PEEK (-16336) "Clicks" APPLE’s speaker. 


SOME MATH FUNCTIONS 


SIN(X) Returns sine of X radians. 
COS(X) Returns cosine of X radians. 
TAN (X) Returns tangent of X radians. 
ATN(X) Returns arctangent, in radians, of X. 
INT(X) Returns largest integer less than 
or equal to X. 
RND(1) Returns random real number fron 
9 to $.999999999 each time used. 

RND(@) Returns last random number again. 
RND(—-3) Returns 4.48217179E-@8. A different 
fixed number is returned for each 
different negative argument. After 

this, RND with positive argument will 
follow a fixed sequence. 
SGN(X) Returns -1 if X<@, @ if X=@, and l 
if X>@. 
ABS (X) Returns absolute value of X. 
SQR(X) Returns positive square root of X. 
EXP(X) Returns e (2.718289) to the power X. 
LOG(X) Returns natural logarithm of X. 


